REC_ Recognition Functions

The REC_ constants specify return values from the GetPenHwEventData1AOBY6 and GetPenHwData functions. They are also returned from the obsolete functions Recognize1AOD10, RecognizeData3BE5AP5, and ProcessWriting1AOD18, and as the wParam value of the WM_RCRESULT message. Return values less than REC_DEBUG are provided for debugging purposes only and represent abnormal termination.

Constant

Description

REC_OK

This result message to be followed by other results before Recognize1AOD10 terminates. This is a valid wParam value for WM_RCRESULT, but it can never be the return value for Recognize1AOD10.

REC_ABORT

Recognition stopped by a call to EndPenCollection with this value. The lpPnt data is not valid.

REC_BADHPENDATA

Returned if HPENDATA cannot be locked or has an invalid header. This value is also returned if HPENDATA has no data in it or if the data is in an incorrect scale or compressed.

REC_BUFFERTOOSMALL

Returned by GetPenHwEventData1AOBY6.

REC_BUSY

Returned if another task is currently performing recognition.

REC_DONE

Returned by RecognizeData3BE5AP5 upon normal completion.

REC_NA

Function not available.

REC_NOINPUT

Returned by RecognizeData3BE5AP5 if the buffer contains no data, or returned by Recognize1AOD10 if recognition ended before any data was collected. For example, a pen-down stroke may have occurred outside the bounding rectangle before any data was collected.

REC_NOTABLET

Tablet not physically present.

REC_OOM

Out-of-memory error.

REC_OVERFLOW

Data overflow during execution of the call.

REC_POINTEREVENT

Returned if the user makes contact with the tablet surface and lifts the pen before the pen tip travels a short distance. This value is also returned if the user does a press-and-hold action; that is, the pen makes contact with the tablet and remains in that position for a short period of time.

REC_POINTEREVENT informs the application it should begin selection actions rather than inking or recognition. If REC_POINTEREVENT is returned, no WM_RCRESULT message is generated and no ink is displayed.

REC_TERMBOUND

Recognition ended because of a hit test outside the bounding rectangle. The pntEnd member of RCRESULT232HBID is filled with the point causing the stop.

REC_TERMEX

Recognition ended because of a hit test inside the exclusion rectangle. The pntEnd member of RCRESULT232HBID is filled with the point causing the stop.

REC_TERMOEM

Values greater than or equal to 512 reserved for recognizer-specific termination reasons.

REC_TERMPENUP

Recognition ended on pen up. ThepntEnd member of RCRESULT232HBID is filled with the pen-up point that terminated recognition.

REC_TERMRANGE

Recognition ended because the pen left the proximity range.

REC_TERMTIMEOUT

Recognition ended on time-out. (The pen was up con-tinuously for a given amount of time.)